<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.18"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Railway Operation Simulator: API.cpp Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td id="projectlogo"><img alt="Logo" src="railway-logo.png"/></td>
  <td id="projectalign" style="padding-left: 0.5em;">
   <div id="projectname">Railway Operation Simulator
   &#160;<span id="projectnumber">v2.23.2</span>
   </div>
   <div id="projectbrief">A railway simulator for Windows</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.18 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
  initMenu('',true,false,'search.php','Search');
  $(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
      <div id="nav-sync" class="sync"></div>
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(document).ready(function(){initNavTree('_a_p_i_8cpp_source.html',''); initResizable(); });
/* @license-end */
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div class="header">
  <div class="headertitle">
<div class="title">API.cpp</div>  </div>
</div><!--header-->
<div class="contents">
<a href="_a_p_i_8cpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno">    1</span>&#160; </div>
<div class="line"><a name="l00007"></a><span class="lineno">    7</span>&#160;<span class="preprocessor">#pragma hdrstop</span></div>
<div class="line"><a name="l00008"></a><span class="lineno">    8</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="_a_p_i_8h.html">API.h</a>&quot;</span></div>
<div class="line"><a name="l00009"></a><span class="lineno">    9</span>&#160; </div>
<div class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span class="comment">//---------------------------------------------------------------------------</span></div>
<div class="line"><a name="l00011"></a><span class="lineno">   11</span>&#160;<span class="preprocessor">#pragma package(smart_init)</span></div>
<div class="line"><a name="l00012"></a><span class="lineno"><a class="line" href="class_a_p_i.html#aea05113c3d6e4567708faedd0496a1e7">   12</a></span>&#160;<a class="code" href="class_a_p_i.html#aea05113c3d6e4567708faedd0496a1e7">API::API</a>(<span class="keyword">const</span> AnsiString&amp; file_name)</div>
<div class="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;{</div>
<div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;   <a class="code" href="class_a_p_i.html#ab8c8347a7be811af2f0c102c2eb3b236">file_path_</a> = file_name;</div>
<div class="line"><a name="l00015"></a><span class="lineno">   15</span>&#160;   <span class="comment">// Print something if program is opened</span></div>
<div class="line"><a name="l00016"></a><span class="lineno">   16</span>&#160;   TIniFile* ini_file_ = <span class="keyword">new</span> TIniFile(<a class="code" href="class_a_p_i.html#ab8c8347a7be811af2f0c102c2eb3b236">file_path_</a>);</div>
<div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;   ini_file_-&gt;WriteBool(<span class="stringliteral">&quot;session&quot;</span>, <span class="stringliteral">&quot;running&quot;</span>, <span class="keyword">true</span>);</div>
<div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;   <a class="code" href="class_a_p_i.html#a77a81598cc3233ba0a21f98aa29889af">reset_excludes_</a>.push_back(<span class="stringliteral">&quot;program_version&quot;</span>);</div>
<div class="line"><a name="l00019"></a><span class="lineno">   19</span>&#160;}</div>
<div class="line"><a name="l00020"></a><span class="lineno"><a class="line" href="class_a_p_i.html#ac531383de112e6ecfe732c72028f31df">   20</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="class_a_p_i.html#ac531383de112e6ecfe732c72028f31df">API::add_metadata_str</a>(<span class="keyword">const</span> AnsiString&amp; label, AnsiString* data)</div>
<div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;{</div>
<div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;    <a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>[label] = data;</div>
<div class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;}</div>
<div class="line"><a name="l00024"></a><span class="lineno"><a class="line" href="class_a_p_i.html#aeeef34d89b6e7cb0086e08ab136c43c7">   24</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="class_a_p_i.html#aeeef34d89b6e7cb0086e08ab136c43c7">API::add_metadata_bool</a>(<span class="keyword">const</span> AnsiString&amp; label, <span class="keywordtype">bool</span>* data)</div>
<div class="line"><a name="l00025"></a><span class="lineno">   25</span>&#160;{</div>
<div class="line"><a name="l00026"></a><span class="lineno">   26</span>&#160;    <a class="code" href="class_a_p_i.html#a398a165383bd7158830ee2f0a98e89a5">metadata_bool_</a>[label] = data;</div>
<div class="line"><a name="l00027"></a><span class="lineno">   27</span>&#160;}</div>
<div class="line"><a name="l00028"></a><span class="lineno"><a class="line" href="class_a_p_i.html#a6d770c4a39e262a9a364a430ac7587f6">   28</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="class_a_p_i.html#a6d770c4a39e262a9a364a430ac7587f6">API::add_metadata_int</a>(<span class="keyword">const</span> AnsiString&amp; label, <span class="keywordtype">int</span>* data)</div>
<div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;{</div>
<div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;    <a class="code" href="class_a_p_i.html#adafb7d74cbe7709debfb54be4d482d4e">metadata_int_</a>[label] = data;</div>
<div class="line"><a name="l00031"></a><span class="lineno">   31</span>&#160;}</div>
<div class="line"><a name="l00032"></a><span class="lineno"><a class="line" href="class_a_p_i.html#a24df4bf6f49e4f42353f4bd04268d4eb">   32</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="class_a_p_i.html#a24df4bf6f49e4f42353f4bd04268d4eb">API::write_string</a>(<span class="keyword">const</span> AnsiString&amp; label, <span class="keyword">const</span> AnsiString&amp; data)</div>
<div class="line"><a name="l00033"></a><span class="lineno">   33</span>&#160;{</div>
<div class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;    <a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>[label] = <span class="keyword">new</span> AnsiString(data);</div>
<div class="line"><a name="l00035"></a><span class="lineno">   35</span>&#160;}</div>
<div class="line"><a name="l00036"></a><span class="lineno"><a class="line" href="class_a_p_i.html#ae4039467fe2652d5826f10224608cd56">   36</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="class_a_p_i.html#ae4039467fe2652d5826f10224608cd56">API::write_int</a>(<span class="keyword">const</span> AnsiString&amp; label, <span class="keyword">const</span> <span class="keywordtype">int</span>&amp; data)</div>
<div class="line"><a name="l00037"></a><span class="lineno">   37</span>&#160;{</div>
<div class="line"><a name="l00038"></a><span class="lineno">   38</span>&#160;    <a class="code" href="class_a_p_i.html#adafb7d74cbe7709debfb54be4d482d4e">metadata_int_</a>[label] = <span class="keyword">new</span> int(data);</div>
<div class="line"><a name="l00039"></a><span class="lineno">   39</span>&#160;}</div>
<div class="line"><a name="l00040"></a><span class="lineno"><a class="line" href="class_a_p_i.html#a12de5384d7783f93cf7b3a19fa0d8e74">   40</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="class_a_p_i.html#a12de5384d7783f93cf7b3a19fa0d8e74">API::write_bool</a>(<span class="keyword">const</span> AnsiString&amp; label, <span class="keyword">const</span> <span class="keywordtype">bool</span>&amp; data)</div>
<div class="line"><a name="l00041"></a><span class="lineno">   41</span>&#160;{</div>
<div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#160;    <a class="code" href="class_a_p_i.html#a398a165383bd7158830ee2f0a98e89a5">metadata_bool_</a>[label] = <span class="keyword">new</span> bool(data);</div>
<div class="line"><a name="l00043"></a><span class="lineno">   43</span>&#160;}</div>
<div class="line"><a name="l00044"></a><span class="lineno"><a class="line" href="class_a_p_i.html#a9709328b5821e6ae094c10770bc5a498">   44</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="class_a_p_i.html#a9709328b5821e6ae094c10770bc5a498">API::find_metadata_file</a>()</div>
<div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;{</div>
<div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;    <span class="keywordflow">try</span> {</div>
<div class="line"><a name="l00047"></a><span class="lineno">   47</span>&#160;        AnsiString search_file_;</div>
<div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160; </div>
<div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;        <span class="comment">// If the current railway is unknown do nothing</span></div>
<div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;        <span class="keywordflow">if</span>(<a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>.find(<span class="stringliteral">&quot;railway&quot;</span>) == <a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>.end())</div>
<div class="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;        {</div>
<div class="line"><a name="l00052"></a><span class="lineno">   52</span>&#160;            <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00053"></a><span class="lineno">   53</span>&#160;        }</div>
<div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160; </div>
<div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;        <span class="comment">// identify the root directory for the current project, it could be in</span></div>
<div class="line"><a name="l00056"></a><span class="lineno">   56</span>&#160;        <span class="comment">// RailOS itself or be from a separate package folder</span></div>
<div class="line"><a name="l00057"></a><span class="lineno">   57</span>&#160;        <span class="keywordflow">if</span>(</div>
<div class="line"><a name="l00058"></a><span class="lineno">   58</span>&#160;            <a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>.find(<span class="stringliteral">&quot;railway_file&quot;</span>) != <a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>.end() &amp;&amp;</div>
<div class="line"><a name="l00059"></a><span class="lineno">   59</span>&#160;            *<a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>[<span class="stringliteral">&quot;railway_file&quot;</span>] != <span class="stringliteral">&quot;&quot;</span></div>
<div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;        )</div>
<div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;        {</div>
<div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;           search_file_ = *<a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>[<span class="stringliteral">&quot;railway_file&quot;</span>];</div>
<div class="line"><a name="l00063"></a><span class="lineno">   63</span>&#160;        }</div>
<div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;        <span class="keywordflow">else</span> <span class="keywordflow">if</span>(<a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>.find(<span class="stringliteral">&quot;session_file&quot;</span>) != <a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>.end() &amp;&amp;</div>
<div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;            *<a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>[<span class="stringliteral">&quot;session_file&quot;</span>] != <span class="stringliteral">&quot;&quot;</span></div>
<div class="line"><a name="l00066"></a><span class="lineno">   66</span>&#160;        )</div>
<div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;        {</div>
<div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;           search_file_ = *<a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>[<span class="stringliteral">&quot;session_file&quot;</span>];</div>
<div class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160;        }</div>
<div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;        <span class="keywordflow">else</span></div>
<div class="line"><a name="l00071"></a><span class="lineno">   71</span>&#160;        {</div>
<div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160;            <span class="comment">// Failed to find so do nothing</span></div>
<div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;            <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00074"></a><span class="lineno">   74</span>&#160;        }</div>
<div class="line"><a name="l00075"></a><span class="lineno">   75</span>&#160; </div>
<div class="line"><a name="l00076"></a><span class="lineno">   76</span>&#160;        <span class="keyword">const</span> AnsiString railways_dir_ = ExtractFilePath(search_file_);</div>
<div class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;        AnsiString root_dir_ = TDirectory::GetParent(TDirectory::GetParent(railways_dir_));</div>
<div class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160; </div>
<div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;        <span class="keyword">const</span> AnsiString file_name_label_ = StringReplace(*<a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>[<span class="stringliteral">&quot;railway&quot;</span>], <span class="stringliteral">&quot; &quot;</span>, <span class="stringliteral">&quot;_&quot;</span>, TReplaceFlags() &lt;&lt;rfReplaceAll);</div>
<div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;        <span class="keyword">const</span> AnsiString toml_file_ = root_dir_ + <span class="stringliteral">&quot;\\&quot;</span> + <span class="stringliteral">&quot;Metadata&quot;</span> + <span class="stringliteral">&quot;\\&quot;</span> + (*<a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>[<span class="stringliteral">&quot;railway&quot;</span>]) + <span class="stringliteral">&quot;.toml&quot;</span>;</div>
<div class="line"><a name="l00081"></a><span class="lineno">   81</span>&#160; </div>
<div class="line"><a name="l00082"></a><span class="lineno">   82</span>&#160;        <span class="comment">// if no file found do nothing</span></div>
<div class="line"><a name="l00083"></a><span class="lineno">   83</span>&#160;        <span class="keywordflow">if</span>(!FileExists(toml_file_)) <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160; </div>
<div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;        <a class="code" href="class_a_p_i.html#a24df4bf6f49e4f42353f4bd04268d4eb">write_string</a>(<span class="stringliteral">&quot;metadata_file&quot;</span>, toml_file_);</div>
<div class="line"><a name="l00086"></a><span class="lineno">   86</span>&#160;    }</div>
<div class="line"><a name="l00087"></a><span class="lineno">   87</span>&#160; </div>
<div class="line"><a name="l00088"></a><span class="lineno">   88</span>&#160;    <span class="keywordflow">catch</span>(Exception &amp;e)</div>
<div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;    {</div>
<div class="line"><a name="l00090"></a><span class="lineno">   90</span>&#160;        <span class="comment">//no action for API errors</span></div>
<div class="line"><a name="l00091"></a><span class="lineno">   91</span>&#160;        <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;    }</div>
<div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;}</div>
<div class="line"><a name="l00094"></a><span class="lineno"><a class="line" href="class_a_p_i.html#abebc08c03ceec2b898d8fe877b0efcba">   94</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="class_a_p_i.html#abebc08c03ceec2b898d8fe877b0efcba">API::dump</a>()</div>
<div class="line"><a name="l00095"></a><span class="lineno">   95</span>&#160;{</div>
<div class="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;    <span class="keywordflow">try</span></div>
<div class="line"><a name="l00097"></a><span class="lineno">   97</span>&#160;    {</div>
<div class="line"><a name="l00098"></a><span class="lineno">   98</span>&#160;        <span class="keywordflow">if</span>(<a class="code" href="class_a_p_i.html#ab8c8347a7be811af2f0c102c2eb3b236">file_path_</a>.IsEmpty()) <span class="keywordflow">return</span>;  <span class="comment">// Do not interrupt ROS if no file specified</span></div>
<div class="line"><a name="l00099"></a><span class="lineno">   99</span>&#160;        TIniFile* ini_file_ = <span class="keyword">new</span> TIniFile(<a class="code" href="class_a_p_i.html#ab8c8347a7be811af2f0c102c2eb3b236">file_path_</a>);</div>
<div class="line"><a name="l00100"></a><span class="lineno">  100</span>&#160;        <span class="keywordflow">if</span>(!ini_file_) <span class="keywordflow">return</span>;  <span class="comment">// Do not interrupt ROS if failure</span></div>
<div class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;        std::map&lt;AnsiString, AnsiString*&gt;::iterator it_str = <a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>.begin();</div>
<div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;        <span class="keywordflow">while</span>(it_str != <a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>.end())</div>
<div class="line"><a name="l00103"></a><span class="lineno">  103</span>&#160;        {</div>
<div class="line"><a name="l00104"></a><span class="lineno">  104</span>&#160;            <span class="keyword">const</span> AnsiString data_ = (it_str-&gt;second) ? *(it_str-&gt;second) : AnsiString(<span class="stringliteral">&quot;&quot;</span>);</div>
<div class="line"><a name="l00105"></a><span class="lineno">  105</span>&#160;            ini_file_-&gt;WriteString(<span class="stringliteral">&quot;session&quot;</span>, it_str-&gt;first, data_);</div>
<div class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;            it_str++;</div>
<div class="line"><a name="l00107"></a><span class="lineno">  107</span>&#160;        }</div>
<div class="line"><a name="l00108"></a><span class="lineno">  108</span>&#160;        std::map&lt;AnsiString, bool*&gt;::iterator it_bool = <a class="code" href="class_a_p_i.html#a398a165383bd7158830ee2f0a98e89a5">metadata_bool_</a>.begin();</div>
<div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;        <span class="keywordflow">while</span>(it_bool != <a class="code" href="class_a_p_i.html#a398a165383bd7158830ee2f0a98e89a5">metadata_bool_</a>.end())</div>
<div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;        {</div>
<div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;            <span class="keyword">const</span> <span class="keywordtype">bool</span> data_ = (it_bool-&gt;second) ? *(it_bool-&gt;second) : <span class="keyword">false</span>;</div>
<div class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;            ini_file_-&gt;WriteBool(<span class="stringliteral">&quot;session&quot;</span>, it_bool-&gt;first, data_);</div>
<div class="line"><a name="l00113"></a><span class="lineno">  113</span>&#160;            it_bool++;</div>
<div class="line"><a name="l00114"></a><span class="lineno">  114</span>&#160;        }</div>
<div class="line"><a name="l00115"></a><span class="lineno">  115</span>&#160;        std::map&lt;AnsiString, int*&gt;::iterator it_int = <a class="code" href="class_a_p_i.html#adafb7d74cbe7709debfb54be4d482d4e">metadata_int_</a>.begin();</div>
<div class="line"><a name="l00116"></a><span class="lineno">  116</span>&#160;        <span class="keywordflow">while</span>(it_int != <a class="code" href="class_a_p_i.html#adafb7d74cbe7709debfb54be4d482d4e">metadata_int_</a>.end())</div>
<div class="line"><a name="l00117"></a><span class="lineno">  117</span>&#160;        {</div>
<div class="line"><a name="l00118"></a><span class="lineno">  118</span>&#160;            <span class="keyword">const</span> <span class="keywordtype">int</span> data_ = (it_int-&gt;second) ? *(it_int-&gt;second) : -1;</div>
<div class="line"><a name="l00119"></a><span class="lineno">  119</span>&#160;            ini_file_-&gt;WriteInteger(<span class="stringliteral">&quot;session&quot;</span>, it_int-&gt;first, data_);</div>
<div class="line"><a name="l00120"></a><span class="lineno">  120</span>&#160;            it_int++;</div>
<div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;        }</div>
<div class="line"><a name="l00122"></a><span class="lineno">  122</span>&#160;        <span class="keywordflow">if</span>(ini_file_) <span class="keyword">delete</span> ini_file_;</div>
<div class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;    }</div>
<div class="line"><a name="l00124"></a><span class="lineno">  124</span>&#160;    <span class="keywordflow">catch</span>(Exception &amp;e)</div>
<div class="line"><a name="l00125"></a><span class="lineno">  125</span>&#160;    {</div>
<div class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;        <span class="comment">//no action for API errors</span></div>
<div class="line"><a name="l00127"></a><span class="lineno">  127</span>&#160;        <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00128"></a><span class="lineno">  128</span>&#160;    }</div>
<div class="line"><a name="l00129"></a><span class="lineno">  129</span>&#160;}</div>
<div class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160; </div>
<div class="line"><a name="l00131"></a><span class="lineno"><a class="line" href="class_a_p_i.html#a3a2f4241ce0a02bea5b9c5bd4129382e">  131</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="class_a_p_i.html#a3a2f4241ce0a02bea5b9c5bd4129382e">API::reset_all</a>()</div>
<div class="line"><a name="l00132"></a><span class="lineno">  132</span>&#160;{</div>
<div class="line"><a name="l00133"></a><span class="lineno">  133</span>&#160;    <span class="keywordflow">try</span></div>
<div class="line"><a name="l00134"></a><span class="lineno">  134</span>&#160;    {</div>
<div class="line"><a name="l00135"></a><span class="lineno">  135</span>&#160; </div>
<div class="line"><a name="l00136"></a><span class="lineno">  136</span>&#160;        std::map&lt;AnsiString, AnsiString*&gt;::iterator it_str = <a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>.begin();</div>
<div class="line"><a name="l00137"></a><span class="lineno">  137</span>&#160;        <span class="keywordflow">while</span>(it_str != <a class="code" href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">metadata_str_</a>.end())</div>
<div class="line"><a name="l00138"></a><span class="lineno">  138</span>&#160;        {</div>
<div class="line"><a name="l00139"></a><span class="lineno">  139</span>&#160;            <span class="keywordflow">if</span>(std::find(<a class="code" href="class_a_p_i.html#a77a81598cc3233ba0a21f98aa29889af">reset_excludes_</a>.begin(), <a class="code" href="class_a_p_i.html#a77a81598cc3233ba0a21f98aa29889af">reset_excludes_</a>.end(), it_str-&gt;first) == <a class="code" href="class_a_p_i.html#a77a81598cc3233ba0a21f98aa29889af">reset_excludes_</a>.end())</div>
<div class="line"><a name="l00140"></a><span class="lineno">  140</span>&#160;            {</div>
<div class="line"><a name="l00141"></a><span class="lineno">  141</span>&#160;                (*it_str-&gt;second) = AnsiString();</div>
<div class="line"><a name="l00142"></a><span class="lineno">  142</span>&#160;            }</div>
<div class="line"><a name="l00143"></a><span class="lineno">  143</span>&#160;            it_str++;</div>
<div class="line"><a name="l00144"></a><span class="lineno">  144</span>&#160;        }</div>
<div class="line"><a name="l00145"></a><span class="lineno">  145</span>&#160;    }</div>
<div class="line"><a name="l00146"></a><span class="lineno">  146</span>&#160;    <span class="keywordflow">catch</span>(Exception &amp;e)</div>
<div class="line"><a name="l00147"></a><span class="lineno">  147</span>&#160;    {</div>
<div class="line"><a name="l00148"></a><span class="lineno">  148</span>&#160;        <span class="comment">//no action for API errors</span></div>
<div class="line"><a name="l00149"></a><span class="lineno">  149</span>&#160;        <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00150"></a><span class="lineno">  150</span>&#160;    }</div>
<div class="line"><a name="l00151"></a><span class="lineno">  151</span>&#160;}</div>
<div class="line"><a name="l00152"></a><span class="lineno">  152</span>&#160; </div>
<div class="line"><a name="l00153"></a><span class="lineno">  153</span>&#160; </div>
<div class="line"><a name="l00154"></a><span class="lineno"><a class="line" href="class_a_p_i.html#a583ec65b542b44e4b7013f5fc830fdcd">  154</a></span>&#160;<a class="code" href="class_a_p_i.html#a583ec65b542b44e4b7013f5fc830fdcd">API::~API</a>()</div>
<div class="line"><a name="l00155"></a><span class="lineno">  155</span>&#160;{</div>
<div class="line"><a name="l00156"></a><span class="lineno">  156</span>&#160;    TIniFile* ini_file_ = <span class="keyword">new</span> TIniFile(<a class="code" href="class_a_p_i.html#ab8c8347a7be811af2f0c102c2eb3b236">file_path_</a>);</div>
<div class="line"><a name="l00157"></a><span class="lineno">  157</span>&#160;    <span class="keywordflow">if</span>(!ini_file_) <span class="keywordflow">return</span>;  <span class="comment">// Do not interrupt ROS if failure</span></div>
<div class="line"><a name="l00158"></a><span class="lineno">  158</span>&#160;    <span class="comment">// Clear session</span></div>
<div class="line"><a name="l00159"></a><span class="lineno">  159</span>&#160;    ini_file_-&gt;EraseSection(<span class="stringliteral">&quot;session&quot;</span>);</div>
<div class="line"><a name="l00160"></a><span class="lineno">  160</span>&#160;    ini_file_-&gt;WriteBool(<span class="stringliteral">&quot;session&quot;</span>, <span class="stringliteral">&quot;running&quot;</span>, <span class="keyword">false</span>);</div>
<div class="line"><a name="l00161"></a><span class="lineno">  161</span>&#160;    <span class="keywordflow">if</span>(ini_file_) <span class="keyword">delete</span> ini_file_;</div>
<div class="line"><a name="l00162"></a><span class="lineno">  162</span>&#160;}</div>
</div><!-- fragment --></div><!-- contents -->
</div><!-- doc-content -->
<div class="ttc" id="aclass_a_p_i_html_a398a165383bd7158830ee2f0a98e89a5"><div class="ttname"><a href="class_a_p_i.html#a398a165383bd7158830ee2f0a98e89a5">API::metadata_bool_</a></div><div class="ttdeci">std::map&lt; AnsiString, bool * &gt; metadata_bool_</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8h_source.html#l00041">API.h:41</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_ae4039467fe2652d5826f10224608cd56"><div class="ttname"><a href="class_a_p_i.html#ae4039467fe2652d5826f10224608cd56">API::write_int</a></div><div class="ttdeci">void write_int(const AnsiString &amp;label, const int &amp;data)</div><div class="ttdoc">write an integer directly to the metadata</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8cpp_source.html#l00036">API.cpp:36</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_a12de5384d7783f93cf7b3a19fa0d8e74"><div class="ttname"><a href="class_a_p_i.html#a12de5384d7783f93cf7b3a19fa0d8e74">API::write_bool</a></div><div class="ttdeci">void write_bool(const AnsiString &amp;label, const bool &amp;data)</div><div class="ttdoc">write a boolean directly to the metadata</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8cpp_source.html#l00040">API.cpp:40</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_adafb7d74cbe7709debfb54be4d482d4e"><div class="ttname"><a href="class_a_p_i.html#adafb7d74cbe7709debfb54be4d482d4e">API::metadata_int_</a></div><div class="ttdeci">std::map&lt; AnsiString, int * &gt; metadata_int_</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8h_source.html#l00042">API.h:42</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_a9709328b5821e6ae094c10770bc5a498"><div class="ttname"><a href="class_a_p_i.html#a9709328b5821e6ae094c10770bc5a498">API::find_metadata_file</a></div><div class="ttdeci">void find_metadata_file()</div><div class="ttdoc">tries to find a metadata file for the currently session</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8cpp_source.html#l00044">API.cpp:44</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_a4ea0e900d0f4bf06ba25587a034f8f4f"><div class="ttname"><a href="class_a_p_i.html#a4ea0e900d0f4bf06ba25587a034f8f4f">API::metadata_str_</a></div><div class="ttdeci">std::map&lt; AnsiString, AnsiString * &gt; metadata_str_</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8h_source.html#l00040">API.h:40</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_a583ec65b542b44e4b7013f5fc830fdcd"><div class="ttname"><a href="class_a_p_i.html#a583ec65b542b44e4b7013f5fc830fdcd">API::~API</a></div><div class="ttdeci">~API()</div><div class="ttdoc">destructor which clears INI file when program is terminated</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8cpp_source.html#l00154">API.cpp:154</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_aea05113c3d6e4567708faedd0496a1e7"><div class="ttname"><a href="class_a_p_i.html#aea05113c3d6e4567708faedd0496a1e7">API::API</a></div><div class="ttdeci">API(const AnsiString &amp;file_name)</div><div class="ttdoc">construct an API object using creating the given INI file</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8cpp_source.html#l00012">API.cpp:12</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_a24df4bf6f49e4f42353f4bd04268d4eb"><div class="ttname"><a href="class_a_p_i.html#a24df4bf6f49e4f42353f4bd04268d4eb">API::write_string</a></div><div class="ttdeci">void write_string(const AnsiString &amp;label, const AnsiString &amp;data)</div><div class="ttdoc">write a string directly to the metadata</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8cpp_source.html#l00032">API.cpp:32</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_abebc08c03ceec2b898d8fe877b0efcba"><div class="ttname"><a href="class_a_p_i.html#abebc08c03ceec2b898d8fe877b0efcba">API::dump</a></div><div class="ttdeci">void dump()</div><div class="ttdoc">save currently recorded status data to INI file</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8cpp_source.html#l00094">API.cpp:94</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_a6d770c4a39e262a9a364a430ac7587f6"><div class="ttname"><a href="class_a_p_i.html#a6d770c4a39e262a9a364a430ac7587f6">API::add_metadata_int</a></div><div class="ttdeci">void add_metadata_int(const AnsiString &amp;label, int *data)</div><div class="ttdoc">add pointer to integer variable to monitor value</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8cpp_source.html#l00028">API.cpp:28</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_a3a2f4241ce0a02bea5b9c5bd4129382e"><div class="ttname"><a href="class_a_p_i.html#a3a2f4241ce0a02bea5b9c5bd4129382e">API::reset_all</a></div><div class="ttdeci">void reset_all()</div><div class="ttdoc">reset all variables</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8cpp_source.html#l00131">API.cpp:131</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_ac531383de112e6ecfe732c72028f31df"><div class="ttname"><a href="class_a_p_i.html#ac531383de112e6ecfe732c72028f31df">API::add_metadata_str</a></div><div class="ttdeci">void add_metadata_str(const AnsiString &amp;label, AnsiString *data)</div><div class="ttdoc">add pointer to string variable to monitor value</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8cpp_source.html#l00020">API.cpp:20</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_aeeef34d89b6e7cb0086e08ab136c43c7"><div class="ttname"><a href="class_a_p_i.html#aeeef34d89b6e7cb0086e08ab136c43c7">API::add_metadata_bool</a></div><div class="ttdeci">void add_metadata_bool(const AnsiString &amp;label, bool *data)</div><div class="ttdoc">add pointer to boolean variable to monitor value</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8cpp_source.html#l00024">API.cpp:24</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_a77a81598cc3233ba0a21f98aa29889af"><div class="ttname"><a href="class_a_p_i.html#a77a81598cc3233ba0a21f98aa29889af">API::reset_excludes_</a></div><div class="ttdeci">std::vector&lt; AnsiString &gt; reset_excludes_</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8h_source.html#l00039">API.h:39</a></div></div>
<div class="ttc" id="aclass_a_p_i_html_ab8c8347a7be811af2f0c102c2eb3b236"><div class="ttname"><a href="class_a_p_i.html#ab8c8347a7be811af2f0c102c2eb3b236">API::file_path_</a></div><div class="ttdeci">AnsiString file_path_</div><div class="ttdef"><b>Definition:</b> <a href="_a_p_i_8h_source.html#l00038">API.h:38</a></div></div>
<div class="ttc" id="a_a_p_i_8h_html"><div class="ttname"><a href="_a_p_i_8h.html">API.h</a></div><div class="ttdoc">File containing classes and methods for broadcasting ROS status data.</div></div>
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  <ul>
    <li class="navelem"><a class="el" href="_a_p_i_8cpp.html">API.cpp</a></li>
    <li class="footer">Generated by
    <a href="http://www.doxygen.org/index.html">
    <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.18 </li>
  </ul>
</div>
</body>
</html>
